home *** CD-ROM | disk | FTP | other *** search
/ Delphi 2.0 - Programmer's Utilities Power Pack / Delphi 2.0 Programmer's Utilities Power Pack.iso / m_to_r / pichrt10 / readme.txt < prev   
Encoding:
Text File  |  1996-09-15  |  2.3 KB  |  63 lines
  1.                     Delphi 2.0 PIECHART Component
  2.  
  3. This Delphi 2.0 PieChart component is part of my ShowMan disk space 
  4. usage program.  It is placed in the public domain by me, but reamins 
  5. copyright of David Taylor, Edinburgh, 1996.  This unit is not required 
  6. to run ShowMan, but would be required to recompile ShowMan.
  7.  
  8. Background
  9.  
  10. I needed a simple pie-chart unit before the arrival of Delphi when
  11. developing an earlier 16-bit version of ShowMan.  The problem of 
  12. detecting just where the mouse had been clicked had also interested me
  13. when developing a simple darts for Windows program (this will not be
  14. publically released) and a darts board does look quite like a pie 
  15. chart.
  16.  
  17. The requirement was for a pie chart that could display text strings 
  18. (i.e. directory or file names) which had an associated value, i.e.
  19. the file or directory size.  In addition, a list box can be associated 
  20. with the pie chart to give a textual display of the data.  Double
  21. clicking a pie segment will result in the caller being notified.  In 
  22. the ShowMan program, this results in a new directory being opened, or
  23. the parent directory if a file rather than a directory is clicked.  
  24. You can code similar behaviour into the list box, should you wish.
  25.  
  26. Data loading
  27.  
  28. To get the data into the pie-chart a TStringList is used, and it is 
  29. assumed that the strings will contain at least a numeric value, and
  30. an optional display label:
  31.  
  32.   12  Carrots
  33.    8  Bananas
  34.   15  Apples
  35.    6  Pears
  36.    5
  37.  
  38. The items will be sorted in ascending value order, and the value can 
  39. have leading spaces.  It is assumed to be a number that can be read 
  40. with the Delphi VAL procedure.
  41.  
  42. What is provided?
  43.  
  44. In addition to the pie chart unit, there is a simple test program 
  45. in PIE_TEST directory.
  46.  
  47. Usage
  48.  
  49. You install the PieChart component just like any other.  I suggest
  50. placing the PIECHART.* files in your normal Delphi library, or you can
  51. put them into their own directory, and add this to your Delphi library 
  52. path.  Use the Component, Install, Add menu.
  53.  
  54. Contacting the author
  55.  
  56. Please note that whilst I cannot deal with any problems you may have 
  57. using this unit, I'd welcome any comments or suggestions you might have
  58. since I don't have a lot of experience writing components....
  59.  
  60.  
  61. david.taylor@gecm.com
  62. 1996 May 26
  63.